Zum Hauptinhalt springen

DND/Ruhe verhindern

Anforderung​

In manchen Situationen muß oder soll verhindert werden, dass Benutzer die Ruhe-Funktion aktivieren und dadurch nicht mehr erreichbar werden.

Leider ist es nicht möglich, Ruhe/DND einfach als Benutzerrecht zu entziehen – ein solches Recht existiert in der STARFACE nicht. Man kann Benutzern nur gänzlich alle Einstellungen verbieten (was dann auch Ruhe/DND umfasst).

Mit der folgenden Konfiguration kann auf das Aktivieren von Ruhe/DND unmittelbar reagiert werden:

  • DND kann als Reaktion sofort wieder deaktiviert werden
  • ein Vorgesetzter kann per E-Mail über die Aktivierung von Ruhe/DND informiert werden

Voraussetzungen​

Admin Power Pack​

Um Benutzereinstellungen programmatisch zu ändern, wird Admin Power Pack benötigt. Eine in Admin Power Pack existierende Benutzervorlage (die Ruhe/DND-Einstellungen anwendet) kann durch EventBridge ausgelöst werden.

Legen Sie zunächst eine Benutzervorlage, wie folgt, an:

  1. Wählen Sie unter (1), im Abschnitt Benutzervorlagen,
  2. die Schaltfläche (2).
  3. Wechseln Sie innerhalb der neu angelegten Benutzervorlage auf den Tab (3).
  4. Deaktivieren Sie dort die Einstellung Ruhe (4).

EventBridge Konfiguration​

Wechseln Sie innerhalb der EventBridge Modulkonfiguration auf den Tab und aktivieren dort den Schalter .

Im darunter befindlichen Bereich werden anschließend live alle Ereignisse aufgelistet, die von der STARFACE ausgelöst bzw. verarbeitet werden. Suchen Sie hier das für Ihren Anwendungsfall relevante bzw. passende Event. Über die Schaltfläche kann das Event direkt in die Event Handling Konfiguration übernommen werden.

Das Event​

Die Aktivierung der Ruhe-Funktion mittels Funktionstaste löst ein FunctionKeyStateChanged-Event aus (1).

Dieses Event enthält drei für unseren Anwendungsfall wichtige Attribute (2):

  1. die AccountId des auslösenden Benutzers ($.functionKey.functionkey.accountId)
  2. den Typ der Funktionstaste ($.functionKey.functionkey.keytype)
  3. den Zustand der Funktionstaste ($.functionKey.state)

Die Funktionstaste Ruhe/DND ist durch den Typ DNDFK gekennzeichnet. Eine aktivierte Funktionstaste hat den Zustand ON.

Die Bedingung für ein Auslösen bei Aktivierung der Funktionstaste lautet daher (3):

Bedingung
type == "DNDFK" && state == "ON"

Wenn diese Bedingung erfüllt ist, soll eine Modul-Aktion ausgelöst werden.

Wählen Sie ExecuteUserTemplate als Modul-Aktion (4). Ein Klick auf die Schaltfläche listet alle verfügbaren Benutzervorlagen und deren interne ID auf, die in Admin Power Pack angelegt sind.

Der Name einer Benutzervorlage kann nach Belieben verändert werden – die interne ID bleibt jedoch gleich.

Die Modul-Aktion ExecuteUserTemplate erwartet die Parameter

  • templateId, die interne ID der Benutzervorlage
  • accountIds, ein Array von accountIds, auf die die Benutzervorlage angewendet werden soll
  • includeAdmins (optional), ein Boolean, der steuert, ob die Benutzervorlage auch auf Admins angewendet werden soll
{
  "templateId": "...",
  "accountIds": [{{accountId}}],
  "includeAdmins": true
}

Der passende Event-Handler​

de.starface.core.component.functionkey.events.FunctionKeyStateChanged
accountId
$.functionKey.functionkey.accountId
state
$.functionKey.state
type
$.functionKey.functionkey.keytype
type == 'DNDFK' && state =='ON'
ExecuteUserTemplate
{
  "templateId": "c041ed13-b3ef-4e4f-a6ac-063b0ec4e66d",
  "accountIds": [{{accountId}}],
  "includeAdmins": true
}
Inhaltsverzeichnis